home *** CD-ROM | disk | FTP | other *** search
/ Amiga Developer CD 2.1 / Amiga Developer CD v2.1.iso / Contributions / Thomas_Richter / Tools / Debugging / MMULib / ReadMe < prev    next >
Encoding:
Text File  |  1999-10-31  |  6.0 KB  |  173 lines
  1. The mmu.library project © 1998,99 the mmu.library development group, THOR
  2. -----------------------------------------------------------------------------
  3.  
  4. This drawer contains the mmu.library and all related tools, most important
  5. debugging tools which might be handy for developing. Most important are
  6. the tools "MuForce" and "MuGuardianAngel" in the "MuTools" directory.
  7.  
  8.  
  9. Disclaimer:
  10. -----------
  11.  
  12. Permission is hereby granted to publish this archive exclusively on the 
  13. Amiga Developer CD 2.1.
  14.  
  15. However, my licence conditions still apply. Study the "THOR-Software Licence"
  16. in the "MMU.guide" for details: NO COMMERCIAL REPRODUCTION WITHOUT PRIOR
  17. WRITTEN PERMISSION OF THE AUTHORS.
  18.  
  19. MuForce is based on and uses code of Michael Sinz's "Enforcer" debugging
  20. tool. Therefore, "MuForce" might be seen as the V40 edition of "Enforcer".
  21. This work wouldn't have been possible without the nice and friendly support 
  22. of Mike I really appreciate.
  23.  
  24. Permission of the authors is given to publish MuForce on the Amiga Dev CD 2.1. 
  25.  
  26.  
  27. A quick start:
  28. --------------
  29.  
  30. Copy the files LIBS/mmu.library and LIBS/disassembler.library to LIBS:, 
  31. keep the "MuTools" wherever you want.
  32.  
  33.  
  34. HOWEVER:
  35. --------
  36.  
  37. This archive contains more than just debugging tools. It's more a completely
  38. new concept that is introduced here, namely that of a system library 
  39. controlling the MMU functions of the more advanced Amiga models and building
  40. a basis for shared access to the MMU. The idea is to have a set of compatible
  41. tools that cooperate nicely with each other, namely...
  42.  
  43.     MMU HACKING HAS TO STOP!
  44.  
  45.  
  46. For a full installation, for a lot of background information, for a selection
  47. of frequently answered questions and answers, please consult the "MMU.guide"
  48. in this directory. It should, hopefully, provide all required information.
  49.  
  50.  
  51. Please read the "Licence" agreement first, then the "What is it" chapter and 
  52. the "Installation" rules.
  53.  
  54. Developers will find all required includes and autodocs in this directory
  55. as well.
  56.  
  57.  
  58. Compatibility
  59. -------------
  60.  
  61. The MuTools and the mmu.library are compatible to all Amiga models with a
  62. working MMU. They will print a warning and fail if no MMU is available.
  63. They are also compatible to WarpOs © H&P, but they are unfortunately *NOT*
  64. compatible to P5's PowerUp and ppc.library.
  65. THIS IS NOT MY FAULT. I contacted P5 to get some internal information to 
  66. support the ppc.library, but little to no interest was shown. I'm still 
  67. willing to support PowerUp, but I won't be able to without cooperation of P5.
  68. Please run WarpOs, and the ppc.library emulation of Frank Wille on top of
  69. it. This combination will work fine.
  70. The mmu.library is also incompable to the Draco © P5 computer, first due to
  71. a name clash, and second because of missing documentation.
  72.  
  73.  
  74. Last minute changes
  75. -------------------
  76.  
  77. Unfortunately, we haven't been able to provide the mmu.library based
  78. 68060.library in time. This doesn't mean that the "MuTools" won't work,
  79. it just means that some memory is wasted because the MMU data structures
  80. will be build twice. Furthermore, 100% waterproof "virtual memory" is 
  81. impossible with all current 68060.library implementations - this is not
  82. related to the mmu.library at all, it's just a fact due to the way how
  83. emulation of unimplemented FPU instructions work.
  84.  
  85. I'm also sorry for not being able to draw all the nice colorful Os 3.5
  86. icons in time. The tools will therefore come in the old four-color style.
  87. In case you want to provide some nicer icons, you're welcome! I'm not an
  88. artist!
  89.  
  90.  
  91. Credits
  92. -------
  93.  
  94. *Thanks a lot!* This project wouldn't have been possible without your
  95. support, help, background information, testing, providing sources! Thanks
  96. for your time and for all the friendly emails!
  97.  
  98.  
  99. Special thanks goes to:
  100.  
  101.  
  102. Michael Sinz:           For explaining me a lot of internals of exec, for
  103. detailed information about the Amiga hardware, for providing the sources of
  104. his "Enforcer", for answering all my stupid questions and for being a nice
  105. guy.
  106.  
  107.  
  108. Ralph Babel:            For answering my questions about caching and the
  109. CachePre/PostDMA() questions, for documenting some of the internals of the
  110. omniscsi.device and hence allowing me to make his "GuruROM" software
  111. mmu.library aware.
  112.  
  113.  
  114. Sam Jordan:             For providing me insight into WarpOs.
  115.  
  116.  
  117. Simon N. Goodwin:       For running a lot of tests on various systems,
  118. especially for some insider information about the Motorola 68060.
  119.  
  120.  
  121. Michaela Prüß:          For making the VBCC includes available for all my
  122. frequent updates and bugfixes.
  123.  
  124.  
  125. Bjoern Schmidt:         For allowing me to run some tests on his 060 and for
  126. taking time for me several afternoons.
  127.  
  128.  
  129. Werner Müller:          For providing a 68040 system for a bargain price
  130. which finally allowed me to write support code for the most tricky member of
  131. the motorola family, and to get rid of my 68030 based system and its
  132. "creative" chip memory.
  133.  
  134.  
  135. Olaf Barthel:           For allowing me to include his program "Sashimi" in
  136. this distribution, for all his great Amiga Software and for building the
  137. DevCD 2.1.
  138.  
  139.  
  140. Richard Körber:         For his great "PatchWork" tool, and for allowing me
  141. to include it in this archive.
  142.  
  143.  
  144. Motorola:               For providing the service of shipping the MC68K
  145. manual to my place for free.
  146.  
  147.  
  148.  
  149. I wish to thank all beta testers, for risking to run the beta software on
  150. their systems and for providing all the information I required to make the
  151. mmu.library great: (in alphabetical order by last name)
  152.  
  153. Stephen Brookes
  154.  Carl Drougge
  155.   Gaelan Griffin (with special thanks for testing this on his 68020/68851)
  156.    Gene Heskett
  157.     Andreas R. Kleinert
  158.      Stéphane PAYET, 29 years and 13 with Amiga.
  159.        Jon Peterson - Avid shareware supporter.
  160.         Raphael 'PIK' Pilarczyk: "Murphy hates me"
  161.          Hynek Schlawack
  162.           Nicholas Stallard
  163.            Flemming Steffensen
  164.             Geoffrey Taylor                Smyrna, TN USA
  165.              Carlos A. Tirado
  166.               Maure Vaughn
  167.                Etienne Vogt
  168.  
  169. -----------------------------------------------------------------------------
  170.  
  171. Thomas Richter,
  172.         October 1999
  173.